home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / deflfo.z / deflfo
Encoding:
Text File  |  2002-10-03  |  7.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddeeeeffffllllffffoooo((((3333GGGG))))                                                          ddddeeeeffffllllffffoooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddeeeeffffllllffffoooo - defines a raster font capable of accommodating large rasters and
  10.      multi-byte character id's
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ddddeeeeffffllllffffoooo((((nnnn,,,, nnnncccc,,,, cccchhhhaaaarrrrssss,,,, nnnnrrrr,,,, rrrraaaasssstttteeeerrrr))))
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn,,,, hhhhtttt,,,, nnnncccc,,,, nnnnrrrr
  15.      iiiinnnntttteeeeggggeeeerrrr****4444 cccchhhhaaaarrrrssss((((5555****nnnncccc)))),,,, rrrraaaasssstttteeeerrrr((((nnnnrrrr))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _n        expects the value to use as the identifier for this raster font.
  19.               The default font is a fixed-pitch ASCII font with a height of
  20.               15, width of 9, character values 0 through 127 defined, and is
  21.               specified by a font identifier of 0.  Font 0 cannot be
  22.               redefined.
  23.  
  24.      _n_c       expects the number of elements in the _c_h_a_r_s array.
  25.  
  26.      _c_h_a_r_s    expects an array of 5 by _n_c four-byte integers.  Since parts of
  27.               certain elements need to be set, declare a ten by _n_c/2 array of
  28.               two-byte integers, and then EQUIVALENCE the new array to the
  29.               _c_h_a_r_s array.
  30.  
  31.               FFFFiiiirrrrsssstttt eeeelllleeeemmmmeeeennnntttt of each row expects the integer value for for this
  32.               character.  When this value is encountered by cccchhhhssssttttrrrr or llllcccchhhhaaaarrrrsssstttt
  33.               this character is drawn.
  34.  
  35.               SSSSeeeeccccoooonnnndddd eeeelllleeeemmmmeeeennnntttt expects the element number of _r_a_s_t_e_r at which the
  36.               bitmap data for this character begins.  Element numbers start at
  37.               zero.
  38.  
  39.               TTTThhhhiiiirrrrdddd eeeelllleeeemmmmeeeennnntttt,,,, hhhhiiiigggghhhh hhhhaaaallllffff----wwwwoooorrrrdddd expects the number of columns in
  40.               the bitmap that contain set bits (character width). TTTThhhhiiiirrrrdddd
  41.               eeeelllleeeemmmmeeeennnntttt,,,, lllloooowwww hhhhaaaallllffff----wwwwoooorrrrdddd expects the number of rows (character
  42.               height) in the bitmap of the character (including ascender and
  43.               descender).
  44.  
  45.               FFFFoooouuuurrrrtttthhhh eeeelllleeeemmmmeeeennnntttt,,,, hhhhiiiigggghhhh hhhhaaaallllffff----wwwwoooorrrrdddd expects the number of bitmap
  46.               columns between the start of the character's bitmap and the
  47.               start of the character.  FFFFoooouuuurrrrtttthhhh eeeelllleeeemmmmeeeennnntttt,,,, lllloooowwww hhhhaaaallllffff----wwwwoooorrrrdddd expects
  48.               the number rows between the character's baseline and the bottom
  49.               of the bitmap.  For characters with descenders (e.g., _g) this
  50.               value is a negative number.  For characters that rest entirely
  51.               on the baseline, this value is zero.
  52.  
  53.               FFFFiiiifffftttthhhh eeeelllleeeemmmmeeeennnntttt,,,, hhhhiiiigggghhhh hhhhaaaallllffff----wwwwoooorrrrdddd expects the number of pixels to
  54.               move in the x-direction after this character is displayed.
  55.               FFFFiiiifffftttthhhh eeeelllleeeemmmmeeeennnntttt,,,, lllloooowwww hhhhaaaallllffff----wwwwoooorrrrdddd expects the number of pixels to
  56.               move in the y-direction after this character is displayed.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddeeeeffffllllffffoooo((((3333GGGG))))                                                          ddddeeeeffffllllffffoooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      _n_r       expects the number of 16-bit integers in _r_a_s_t_e_r.
  75.  
  76.      _r_a_s_t_e_r   expects a one-dimensional array containing all the bitmap data
  77.               for the characters in the font.  The bitmap data for each
  78.               character is a set of consecutive, 16-bit integers, comprising
  79.               the bit mask for the character from left to right, bottom to
  80.               top.  For characters of width greater than 16, the rows of a
  81.               bitmap span more than one array element, however, each new row
  82.               in the character bitmap must start with its own array element.
  83.  
  84.               The number of 16-bit integers per row in a character's bitmap is
  85.               (_w+15)/16.  The total number of 16-bit integers in a character's
  86.               raster definition is _h*((_w+15)/16).
  87.  
  88.               Bit 15 of each element is left-most when displayed.  Bits that
  89.               are '1' are drawn, bits that are '0' are masked.
  90.  
  91. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  92.      ddddeeeeffffllllffffoooo defines a new raster font, or adds/replaces character definitions
  93.      in the current raster font.  If the font did not exist, it is created.
  94.      If it did exist, the character descriptions in the current call replace
  95.      any currently defined characters of the same value.
  96.  
  97.      ddddeeeeffffllllffffoooo and ddddeeeeffffrrrraaaassss share the same name space for font id's, so programmers
  98.      should beware of collisions.  Also, raster fonts initially defined with
  99.      ddddeeeeffffrrrraaaassss may not augment their character sets via subsequent calls to
  100.      ddddeeeeffffllllffffoooo.
  101.  
  102.      If ddddeeeeffffllllffffoooo is called with _n_c set to zero, the font is deleted.
  103.  
  104. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.      charst, cmove, font, getcpo, getdes, getfon, gethei, lchstr, lstwid,
  106.      strwid
  107.  
  108. NNNNOOOOTTTTEEEE
  109.      This routine is available only in immediate mode.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.